Skip to content

docs(changelog): a runner has a page of its own, and every list pages by cursor - #164

Merged
indykish merged 2 commits into
mainfrom
chore/m146-runner-lease-surface-changelog
Jul 30, 2026
Merged

docs(changelog): a runner has a page of its own, and every list pages by cursor#164
indykish merged 2 commits into
mainfrom
chore/m146-runner-lease-surface-changelog

Conversation

@indykish

@indykish indykish commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Companion docs for agentsfleet/agentsfleet#577 (M146_001).

The Jul 30 <Update> covers the runner surface and the pagination retirement: the two new operator reads with their scopes, envelopes and error codes; the three reads that drop page/page_size; the fleets cursor rename; the memory envelope change; the retired client flags with their replacements; and the two additive index migrations. Upgrading leads, since client and server move together on all four breaks.

memory.mdx gains the new --starting-after flag beside the existing list example, and states that the dashboard panel walks the cursor to the end so it shows every entry.

make lint passes (its DOC-03 paragraph check caught a four-sentence paragraph, since split).

Land alongside or just after the product PR — the flags and envelopes documented here only exist once that merges and deploys.

🤖 Generated with Claude Code

Greptile Summary

Documents the runner detail surface and platform-wide cursor pagination changes.

  • Adds the July 30 changelog entry covering API, CLI, dashboard, and migration changes.
  • Adds runner detail and lease endpoints to API navigation.
  • Explains memory-list cursor behavior and dashboard traversal.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
changelog.mdx Adds the July 30 release notes; the prior runner-events pagination omission is fully addressed with cursor parameters and traversal guidance.
docs.json Adds the runner detail and runner lease endpoints to the API reference navigation.
memory.mdx Documents memory-list cursor pagination and the dashboard's complete cursor traversal.

Reviews (2): Last reviewed commit: "docs: list the new runner reads and page..." | Re-trigger Greptile

… by cursor

The Jul 30 entry covers the runner surface and the pagination retirement:
the two new operator reads with their scopes, envelopes and error codes,
the three reads that drop page and page_size, the fleets cursor rename,
the memory envelope change, the retired client flags with their
replacements, and the two additive index migrations. Upgrading leads,
since client and server move together on all four breaks.

The memory page documents the new --starting-after flag alongside the
existing list example, and states that the dashboard panel walks the
cursor to the end so it shows every entry.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Comment thread changelog.mdx Outdated
Greptile asked for the runner-events entry to name its paging. It was
already in Upgrading, where the template puts breaking changes, but two of
the three list-endpoint references showed starting_after and limit while
that one did not — so the reference line now stands on its own and says to
follow next_cursor.

The drift check then caught the bigger gap, which only became visible once
the product change deployed its OpenAPI: both new operator reads are
published upstream but were absent from docs.json, so the site documented
neither. GET /v1/fleets/runners/{id} and .../{id}/leases join the Fleet
group beside the sibling runner operations.

Runner paths publish as {id}, matching the PATCH and DELETE that already
lived there, so the changelog's five {runner_id} spellings follow the
published spec. The dashboard route keeps {runner_id} — it is a UI path,
not an OpenAPI one.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@indykish
indykish merged commit ac8fe61 into main Jul 30, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant